祖先 The Predecessor runoff¶

roff 系统的演变与操作系统的历史紧密联系。 它的 “先祖” runoff 是 Jerry Saltzer 在 CTSS 操作系统 (Compatible Time Sharing System ，兼容分时系统 (?)，1961) 上的作品。 CTTS 后来发展成为操作系统 Unix 的一个著名的来源，出现于 1963，同时 runoff 成为文档和文本处理的主要格式。 当时，这两种操作系统只能运行在非常昂贵的计算机之上， 因此它们大部分用于研究和官方及军队的任务之中

与现代的 roff 相比， runoff 语言可以做的事非常有限。 在 60 年代，只能产生文本的输出。 这可以用一个长度为 2 的命令 (request) 的集合实现， 这些命令的绝大部分都保持不变地被 roff 采用。 这种语言的模型是根据 “前计算机时代” 的排版习惯而建立的， 那时，以点 (dot, `.') 开头的行被写在手稿中， 向之后进行手工排版工作的工人指示格式化的要求

开始，runoff 程序是用 PL/1 语言写成的，后来用 BCPL 来写－－那是 C 编程语言的 “祖母”。 在 Multics 操作系统中，帮助系统由 runoff 来处理， 与 roff 管理 Unix 手册页的作用类似。 仍然有 runoff 语言写成的文档， 例如可以到 Saltzer 的主页看看。参见 SEE ALSO 段

传统的 nroff/troff 系统 The Classical nroff/troff System¶

在 70 年代，Multics 的后裔 (offspring) Unix 变得越来越普遍，因为它可以运行在廉价的计算机上， 并且那时在大学里可以很容易地获得。 在 MIT (麻省理工，the Massachusetts Institute of Technology), 有人想在一台运行 Unix 的 PDP-11 计算机上驱动 Wang (王安公司?) 的 Graphic Systems CAT 排字机，一种图形化的输出设备。 由于 runoff 在这种任务上能力有限，它被 Josef F. Osanna, (Multics 操作系统的主要开发者之一，几个 runoff 移植系统的作者) 继续开发，成为一种更强大的文本排版系统

runoff 这个名字被简化为 roff. Ocsanna 所设想的，极大扩展了的语言已经包含了一个完整的 roff 系统的所有元素。 所有现代的 roff 系统都试图实现同这个系统兼容。 因此 Joe Osanna 是当之无愧的所有 roff 系统之父

最早的 roff 系统有三个排版程序

troff

(typesetter roff) 为它唯一支持的 CAT 排字机产生一个图形的输出

nroff

为终端和文本打印机产生合适的文本输出

roff

对最初的 runoff 程序的有限功能进行重新实现； 这个程序在后来的版本中被抛弃。 现在， roff 这个名字只用来指代一个 troff/nroff 系统的整体

Osanna 的第一版用 PDP-11 的汇编语言实现，发布于 1973. Brian Kernighan 加入到 roff 的开发中，使用 C 编程语言将它进行了重写。 C 版本发布于 1975.

nroff/troff 程序使用的排版语言的语法记载在著名的 Troff User's Manual [CSTR #54] 中，出版于 1976, Brian Kernighan 对它不断修订，直到 1992 年。 此文档是对传统的 classical troff 的说明. 所有后来的 roff 系统都试着与这个说明实现兼容

1977 年，Osanna 在他 50 岁时，由于一次突发的心脏病而去世。 Kernighan 继续开发 troff。 下一个开发目标是赋予 troff 一个更一般的接口，以支持更多设备， 中间输出格式和 “后处理” 系统。 这使得 roff 系统的结构趋于完整，现在仍然被使用。参见 USING ROFF 段。 1979 年，它们被写入论文 [CSTR #97]. 这个新的 troff 版本是所有现存的较新的 troff 系统的基础，包括 groff. 在一些系统上，这个设备无关的 troff 有一个可执行文件叫做 ditroff(7). 所有现代的 troff 程序都已经自动提供了对 distroff 完整的兼容性

商业化 Commercialization¶

免费的 Unix 7 操作系统商业化之后，出现了严重的退步。 一大批不同的操作系统浮出水面，为他们所作的扩展间的互不兼容而争斗。 幸好，这种不兼容没有影响到原始的 troff。 所有不同的商业版本的 roff 系统都大量使用了 Osanna/Kernighan 的开放的源代码和文档，但是却将其作为 它们的 系统 (“their” system) 出售— 只有很少的修改

古老的 Unix 和传统的 troff 的源代码在长达 20 年时间里不再可以自由获得。

幸运的是，Caldera 收购了 SCO UNIX (2001). 随后，Caldera 使得源代码可以在网上获得，允许用于非商业用途。参见 SEE ALSO 段

(译注：谁能想到，现在，2003 年，SCO会成为自由软件和开源软件界共同的敌人呢？ 而Caldera 又在什么地方呢？)

自由的 Free roff¶

任何商业的 roff 系统都无法成为 roff 开发中的后继者。 商业社会中的每个人都只对他们自己的事情感兴趣。 这使得曾经如此优秀的 Unix 操作系统在 80 年代一蹶不振

作为对如此快速的商业化过程的补救 (As a counter-measure to the galopping commercialization，还请重新翻译)， AT&T Bell Labs 贝尔实验室试图发起一个恢复性的项目 (？，a rescue project) ，使用他们的 Plan 9 操作系统。 它可以免费用于非商业用途，甚至包含了源代码。 但是它有一个专利许可证，that empedes the free development ( 还请解释词义)。 这种想法早已过时，因此 Plan 9 没有被主流开发者接受为自己的平台

真正的补救措施 (？， remedy) 是不断出现的自由操作系统 (386BSD, GNU/Linux, 等等.) 和 80 年代到 90 年代的自由软件工程。 他们实现了传统的 Unix 的特性和很多扩展，因此旧的 “XP体验” 不会丢掉 (such that the old experience is not lost)。 进入 21 世纪，类 Unix 系统重新成为计算机工业中的主导因素 — 这要感谢自由软件

最重要的自由 roff 计划是 GNU 移植版本的 troff， 由 James Clark 建立，使用 它叫做 groff (GNU roff). 参见 groff(1) 中的概述

groff 系统仍然在继续开发。 它与传统 troff 兼容，但是还添加了很多扩展。 它是第一个可以在几乎所有操作系统上运行的 roff 系统并且 — 它是自由开放的。 这使得 groff 成为现在 roff 的事实标准

管道 The roff Pipe¶

roff 系统由预处理器 (preprocessor)，roff 排版程序和后处理器 (postprocessor) 组成。 这种结构使用了大量的管道 piping 机制，意思是，一系列的程序陆续地被调用， 队列中的每个程序的输出就作为下一个程序的输入

\

\)\$*

预处理器产生 roff 代码，传给一个 roff 处理器 (例如，troff)， 然后 roff 处理器接下来产生中间输出，传给一个后处理器程序， 用来打印或者产生最终输出

所有这些组件都使用它们自己的程序语言； 每种语言是与其他组件完全无关的。 此外，还可以包括为特殊目标而制作 (tailor) 的 roff 宏包

大多数 roff 文档中掺杂着使用一些包中的宏、 一个或多个预处理器的代码，还会添加 roff 语言中的一些元素。 用户很少需要用到 roff 排版语言的完整功能； 只有宏包的作者需要知道底层细节 (gory details)

预处理器 Preprocessors¶

预处理器是任何产生符合 roff 排版语言语法的输出的程序。 每个预处理器都有它自己的语言，在预处理器运行时被翻译为 roff 代码。 roff 文档中可以包含以这种语言写成的片段； 它们可以被特殊的 roff 命令或宏识别 (they are identified by special roff requests or macros)。 加入了预处理器代码的文档必须通过所有相应的预处理器处理之后， 才能传给真正的 roff 排版程序， 因为真正的 roff 排版程序会忽略所有陌生的代码。 预处理器只会分析并转换指定由它处理的文档部分

有大量的自由/商业 roff 预处理器。 一些不能在所有系统上使用， 还有一些预处理器被认为是 roff 系统不可分割的部分。 传统的预处理器有

其他已知预处理器，但不是在所有系统上都可用，包括

排版程序 Formatter Programs¶

A roff formatter 排版程序是一个解释用 roff 排版语言或 roff 宏包写成的文档的程序。 它产生中间结果 intermediate output, 将送入单一设备后处理器。后处理器必须在排版程序的命令行选项中指定。 文档必须已经通过了所有需要的预处理器处理

roff 排版程序的输出以另外一种语言表示： intermediate output format 或 troff output. 这种语言最初详述在 [CSTR #97] 中；它的 GNU 扩展记载在 groff_out(5) 中。 中间输出语言与高级的 roff 语言相比像一种汇编指令语言。 产生的中间输出是为一种特定的设备优化过的， 但是对于所有设备，这种语言都适用

roff 排版程序是整个 roff 系统的核心。 传统 roff 有两个排版程序： 对应字符设备的 nroff 和对应图形设备的 troff

通常， troff 这个名字泛指这两种排版程序 (is used as a general term to refer to both formatters)。

设备 后处理器 Devices and Postprocessors¶

设备是类似打印机、字符或图形终端等的硬件接口， 或者是用于转换为另一种字符或图形设备的软件接口

后处理器是将 troff 输出转化为一种适于某种特殊设备的格式的程序。 对于输出目标来说，roff 后处理器像是它们的设备驱动

每种设备都有为其优化的后处理器程序。. 后处理器解释中间输出，产生设备相关的代码，传送给设备

设备名和后处理器程序的名称是不固定的， 因为它们依赖于计算机的软硬件的能力。 例如， [CSTR #54] 中提到的传统的设备名已经有了极大的改变。 旧的硬件不再存在，旧的图形转换程序与现代同等功能的程序相比太不精确了

例如，Postscript 设备 post 在传统 troff 中分辨率是 720，而 groff 的 ps 设备是 72000, 提高了 100 倍

现在，操作系统为大多数类似打印机的硬件提供了设备驱动， 因此不必为每个打印机写一个特殊的后处理器

宏包 Macro Packages¶

宏包是一些适于以便利的办法格式化某种特殊文档的宏的集合。 它们简化了 roff 的使用。 一个包的宏定义保存在一个叫做 name.tmac 的文件中 (传统的命名是 tmac.name). 所有 tmac 文件保存在标准位置的一个或多个目录中。 有关宏包的命名和位置的细节可以看 groff_tmac(5).

文档中用到的宏包可以使用命令行选项 \)\$* 提供给排版程序, 参见 troff(1), 它们也可以在文档中指定，使用 roff 语言的 “包含文件” 命令，参见 groff(7).

著名的传统宏包有 man 用来处理传统手册页 mdoc 处理 BSD 样式的手册页；此类书籍、文档和信件的宏集合是 me (命名也许是根据它的创造者之名 Eric Allman 而来), ms (命名来自 Manuscript Macros), 还有 mm (命名来自 Memorandum Macros).

roff 排版语言 The roff Formatting Language¶

传统的 roff 排版语言记述在 troff 用户手册 Troff User's Manual [CSTR #54] 中. roff 语言是完整的编程语言，提供了命令 (request)，宏定义，转义序列 (escape sequence)， 字符串变量，数字或数量寄存器 (number or size registers)，还有流程控制语句

Requests “命令” 是预定义的基础的排版命令，与 shell 提示下的命令类似。 用户可以定义类似 “命令” 的元素，使用 roff 的 “预定义” 元素。 用户定义的命令就被叫做 “宏” macros. 文档作者不会体会到 命令和宏 之间用法的任何区别； 它们都写在一行中，并以一个点 (dot, `.') 开始

Escape sequences “转义序列” 是以反斜杠 (backslash, `\f[B]\*[@1]\f[]'\$* ) 开始的 roff 元素。 它们可以被插入到任何地方，包括文本的一行中间。 它们用来实现不同的功能，可以使用 \)\$* 插入非 ASCII 字符，使用 \)\$* 改变字体，使用 \)\$* 插入行内注释，它们也可以转义特殊的控制字符，像这样 \)\$* 还有很多很多其他的功能

Strings “字符串” 是存储一个字符串的变量。 字符串以 .ds 命令存储。 存储的字符串可以用 \* 转义序列获得

Registers “寄存器” 存储数字和数量。 寄存器可以用 .nr 命令设置，然后用控制序列 \n 来获得它的值

Internet sites¶

troff.org

提供了 roff 所有历史方面的概述和指引。 这个网站仍在建设；但是，它将成为 roff 历史的主要来源

Multics

包含很多 MIT 的项目的信息，CTSS，Multics，早期的 Unix，还包括 runoff; 尤其有用的是一个术语字典，还有很多到古老的文档的链接

Unix Archive

提供了古老的 Unix 的源码和一些二进制文件 (包括 troff 的源码和它的文档)，它们 是 Caldera 自 2001 年以来公开的，例如著名的 Unix 版本 7 的 PDP-11 平台版本位置是

Developers at AT&T Bell Labs

提供了搜索早期开发者信息的功能

Plan 9

AT&T Bell Labs 贝尔实验室的作品

runoff

保存了古老的 runoff 排版语言写成的一些文档

CSTR Papers

保存了原始的 troff 手册 (CSTR #54, #97, #114, #116, #122) 还有著名的有关编程的历史文档

GNU roff

提供了 自由的 roff 实现：groff，并且它是 roff 的事实标准

历史文档 Historical roff Documentation¶

很多 历史文档仍然可以在线获得。 troff 语言主要的两部手册是

[CSTR #54]

J. F. Osanna, (《用户手册》) Bell Labs, 1976; revised by Brian Kernighan, 1992.

[CSTR #97]

Brian Kernighan, (《设备无关的 troff》) Bell Labs, 1981, revised March 1982.

将 roff 作为一种“小语言”("little language") 来讲述的论文有

[CSTR #114]

Jon L. Bentley and Brian W. Kernighan, (《grap: 一种图形排版语言》) Bell Labs, August 1984.

[CSTR #116]

Brian W. Kernighan, (《pic: 一种排版用的图形控制语言》) Bell Labs, December 1984.

[CSTR #122]

J. L. Bentley, L. W. Jelinski, and B. W. Kernighan, (《chem: 排版化学结构图的程序，计算机与化学》) Bell Labs, April 1986.

手册页 Manual Pages¶

由于它结构复杂，完整的 roff 系统包含很多很多手册页， 每一个都描述了 roff 的一个方面。 不幸的是，不同的 roff 实现之间，它们的手册没有相同的命名格式

在 groff 中，手册页 groff(1) 包含了 groff 相关的所有文档的索引

其他系统中，你需要自己探索，但是 troff(1) 是个很好的起点